home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 (Alt) / MACD 5.bin / workbench / libs / dfunclib.lha / dfunc_library / Dfunc.readme
Encoding:
Text File  |  1995-12-14  |  4.0 KB  |  143 lines
  1. Short:    Tool library. Gadgets,text,converting +
  2. Author:   Kenneth C. Nilsen (kenneth@norconnect.no)
  3. Uploader: Kenneth C. Nilsen (kenneth@norconnect.no)
  4. Type:     util/libs
  5.  
  6.  
  7. dfunc.library ver. 37.14
  8.  
  9.  
  10. Manual
  11. ======
  12.  
  13.     dfunc.library
  14.  
  15.     Copyright © 1994, 1995 by Kenneth C. Nilsen/Digital Surface.
  16.     All rights reserved.
  17.  
  18.     This library is freely distributable as long as no charges is made
  19.     except from a little fee covering media expenses.
  20.  
  21.     This archive is allowed to be distributed with the Fred Fish
  22.     collection, AmiNet, BBSes and PD libraries.
  23.  
  24.     Feel free to use it with your own application. I'll feel happy if you
  25.     credit my work. Not allowed to be used with commercial software
  26.     without a written permission. Shareware authors can also use it, but
  27.     not without a deal (I am not greedy though).
  28.  
  29.  
  30.     The library requires v37 and 68000 to run.
  31.  
  32.  
  33. About
  34. =====
  35.  
  36.  
  37. This library is a multipurpose library.  It covers aspects from low functions
  38. to functions rendering graphics, gadgets and texts.  For use with interactive
  39. programs, multimedia programs, utilities and entertainment.
  40.  
  41. The  gadgets  are powerful, fully scalable and allows customizing and images.
  42. The  gadgets  can  start processes independed on the main program, has a mask
  43. field which is useful with interactiv application and eg.  games.
  44.  
  45. It  has  many  powerful text routines, for example the DFStripText() function
  46. which  stripps  any  type  of  comments.  It has also text rendering routines
  47. where  you  can  give  a  pointer  to  a normal text file and print it in the
  48. rastport  centered or not, of a window or to printer directly.  It will later
  49. support ansi texts.
  50.  
  51. It has most function needed for making life easier.
  52.  
  53. It is 100% system friendly and it's written in assembler to make speed affort
  54. and small size.
  55.  
  56. It contains example sources.
  57.  
  58. It is freeware!
  59.  
  60.  
  61.  
  62. Notes
  63. =====
  64.  
  65.  
  66. It  contains  full  developer  information.   One  note thow:  The autodoc is
  67. written  after  the  library  was  written.   That  means there might be some
  68. mistyping,  wrong  explinations  and  the C prototypes are not correctly yet.
  69. This  is  the  first beta version of the autodoc so don't blame me yet.  It's
  70. anyway useful for most programmers.
  71.  
  72. I  correct  all  this  faults  in  a  later version.  Boy one get tired of an
  73. autodoc after writting 80K text...
  74.  
  75. I have also used "struct gadlist *" in the C prototypes.  This is not correct
  76. since  the gadgetlists are not a structure.  Will be corrected along with all
  77. the other C prototypes errors (wonder why I am programming assembler ;).
  78.  
  79.  
  80.  
  81. Archive
  82. =======
  83.  
  84.  
  85. This  archive  contains BETA version of the library.  That means there may be
  86. some bugs in the library and/or bad explinations in the autodocs.
  87.  
  88. Most private functions are not explained and they don't have to be. :)
  89. See the FD file file for PRIVATE functions. They may change in new releases.
  90.  
  91.  
  92.  
  93. Explainations
  94. =============
  95.  
  96.  
  97. "List of gadget structures" (<input> in the autodocs)
  98.  
  99.     This is one of the powers with this library. You can set up a list og
  100.     gadget structures after each other and end the list with a -1. In
  101.     this way you don't have to mess around with complicated routines to
  102.     set up system gadgets. See example sources to see how this is done.
  103.  
  104.  
  105.  
  106. Overview
  107. ========
  108.  
  109.  
  110. The library is still at its beta stage. I haven't had time to test all
  111. functions, but I haven't discovered major bugs yet.
  112.  
  113. Please report any kind of bugs you find via e-mail.
  114.  
  115. Questions about the usage?  E-mail me and I'll be happy to explain.
  116.  
  117. I  am trying to use the registers so they will be easy to remember.  I always
  118. start  with  the  lowest register number and uses Ax regs for pointers and Dx
  119. for  flags,  options  and values.  The regs start with 0 from left and the fd
  120. are sorted so the address registers start first.  Example:
  121.  
  122. Example(Buffer,Text,FileName,size,options,mask) will have this reg layout:
  123.  
  124. (a0,a1,a2,d0,d1,d2)
  125.  
  126.  
  127.  
  128. Author
  129. ======
  130.  
  131.  
  132. To report any bugs, critism, questions :
  133.  
  134.  
  135.     e-mail: kenneth@norconnect.no
  136.  
  137.  
  138.     Digital Surface
  139.     attn: Kenneth C. Nilsen
  140.     Kvernhusrenen 31
  141.     N-5227 S-Neset
  142.     (Norway)
  143.